-
Notifications
You must be signed in to change notification settings - Fork 10.1k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
fix README table #4260
fix README table #4260
Conversation
Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA). View this failed invocation of the CLA check for more information. For the most up to date status, view the checks section at the bottom of the pull request. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This change still does not fix this issue, as a single line is being split into more than one rows.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This can be fixed if we do not split a single line into multiple lines in the markdown code, as shown below:
| Feature | Description |
|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| xUnit test framework | GoogleTest is based on the [xUnit](https://en.wikipedia.org/wiki/XUnit) testing framework, a popular architecture for unit testing. |
| Test discovery | GoogleTest automatically discovers and runs your tests, eliminating the need to manually register your tests. |
| Rich set of assertions | GoogleTest provides a variety of assertions, such as equality, inequality, exceptions, and more, making it easy to test your code. |
| User-defined assertions | You can define your own assertions with Googletest, making it simple to write tests that are specific to your code. |
| Death tests | GoogleTest supports death tests, which verify that your code exits in a certain way, making it useful for testing error-handling code. |
| Fatal and non-fatal failures | You can specify whether a test failure should be treated as fatal or non-fatal with Googletest, allowing tests to continue running even if a failure occurs. |
| Value-parameterized tests | GoogleTest supports value-parameterized tests, which run multiple times with different input values, making it useful for testing functions that take different inputs. |
| Type-parameterized tests | GoogleTest also supports type-parameterized tests, which run with different data types, making it useful for testing functions that work with different data types. |
| Various options for running | GoogleTest provides many options for running tests, including running individual tests, running tests in a specific order, and running tests in parallel. |
Preview of the above table
Feature | Description |
---|---|
xUnit test framework | GoogleTest is based on the xUnit testing framework, a popular architecture for unit testing. |
Test discovery | GoogleTest automatically discovers and runs your tests, eliminating the need to manually register your tests. |
Rich set of assertions | GoogleTest provides a variety of assertions, such as equality, inequality, exceptions, and more, making it easy to test your code. |
User-defined assertions | You can define your own assertions with Googletest, making it simple to write tests that are specific to your code. |
Death tests | GoogleTest supports death tests, which verify that your code exits in a certain way, making it useful for testing error-handling code. |
Fatal and non-fatal failures | You can specify whether a test failure should be treated as fatal or non-fatal with Googletest, allowing tests to continue running even if a failure occurs. |
Value-parameterized tests | GoogleTest supports value-parameterized tests, which run multiple times with different input values, making it useful for testing functions that take different inputs. |
Type-parameterized tests | GoogleTest also supports type-parameterized tests, which run with different data types, making it useful for testing functions that work with different data types. |
Various options for running | GoogleTest provides many options for running tests, including running individual tests, running tests in a specific order, and running tests in parallel. |
The thing is, this was the actual change which was done by the previous contributor in #4231 And I couldn't find a way to make multi-line rows in raw md map to a single cell. |
@pratyush3757 I am not sure what caused it to happen. But since it is not possible to wrap long lines in markdown code (at least in GitHub Flavored Markdown), this is the only way to fix this issue. See this. Additional References |
@Rahul-Dixit
As for what caused it to happen, it's probably a formatting step done in the CI pipeline before merge. So even if I do what you suggested previously, it'd be mangled during the merge again. Most formatting rules have a line length limit (often 80 characters). I could, however, avoid a table altogether and make it a nested list. |
Because it isn't possible to achieve that using GitHub Flavored Markdown, and I made it clear in my last comment.
Yes, these alternatives may be used. |
This was caused by internal auto-formatting when we imported the original change. I don't think a table is particularly useful here to justify maintaining any workaround. This PR looks good to me. |
The feature table was broken and had description coming into feature column